home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / sar.z / sar
Text File  |  1998-10-20  |  11KB  |  263 lines
  1.  
  2.  
  3.  
  4. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sar - system activity reporter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssaaaarrrr [----uuuubbbbddddyyyyccccwwwwaaaaqqqqvvvvmmmmpppprrrrttttgggghhhhIIIIAAAAUUUUTTTTRRRR] [----oooo file] t [ n ]
  13.  
  14.      ssssaaaarrrr [----uuuubbbbddddyyyyccccwwwwaaaaqqqqvvvvmmmmpppprrrrttttgggghhhhIIIIAAAAUUUUTTTTRRRR] [----ssss time] [----eeee time] [----iiii sec] [----ffff file]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _s_a_r, in the first instance, samples cumulative activity counters in the
  18.      operating system at _n intervals of _t seconds, where _t should be 5 or
  19.      greater.  If the ----oooo option is specified, it saves the samples in _f_i_l_e in
  20.      binary format.  The default value of _n is 1.  In the second instance,
  21.      with no sampling interval specified, ssssaaaarrrr extracts data from a previously
  22.      recorded _f_i_l_e, either the one specified by ----ffff option or, by default, the
  23.      standard system activity daily data file ////vvvvaaaarrrr////aaaaddddmmmm////ssssaaaa////ssssaaaa_d_d for the current
  24.      day _d_d.  The starting and ending times of the report can be bounded via
  25.      the ----ssss and ----eeee _t_i_m_e arguments of the form _h_h[:_m_m[:_s_s]].  The ----iiii option
  26.      selects records at _s_e_c second intervals.  Otherwise, all intervals found
  27.      in the data file are reported.
  28.  
  29.      In either case, subsets of data to be printed are specified by option:
  30.  
  31.      ----uuuu   Report CPU utilization (the default):
  32.           %usr, %sys, %intr, %wio, %idle, %sbrk - portion of time running in
  33.           user mode, running in system mode, processing interrupts, idle with
  34.           some process waiting for I/O, completely idle or idle with some
  35.           process waiting because system memory is scarce, respectively.
  36.           These six percentages add up to 100%.  The time that the processor
  37.           spent in ``idle waiting for I/O'' state is further broken down into
  38.           the following categories:
  39.           %wfs - waiting for file system I/O
  40.           %wswp - waiting for swap I/O to complete
  41.           %wphy - waiting for physio other than swapping
  42.           %wgsw - waiting for graphics context switch to complete
  43.           %wfif - waiting while graphics pipe too full
  44.           These five numbers add up to 100% of the %wio time.
  45.  
  46.      ----bbbb   Report buffer activity:
  47.           bread/s, bwrit/s - basic blocks transferred between system buffers
  48.           and disk or other block devices;
  49.           lread/s, lwrit/s - basic blocks transferred from system buffers to
  50.           user memory;
  51.           wcncl/s - pending writes in system buffers cancelled;
  52.           %rcach, %wcach - cache hit ratios, that is, (1-bread/lread) as a
  53.           percentage;
  54.           pread/s, pwrit/s - basic block transfers via raw (physical) device
  55.           mechanism.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  70.  
  71.  
  72.  
  73.      ----dddd   Report activity for each block device, i.e., disk drives.  When data
  74.           is displayed, the device specification _d_s_k- is generally used to
  75.           represent a disk drive.  The activity data reported is:
  76.           %busy, avque - portion of time device was busy servicing a transfer
  77.           request, average number of requests outstanding during that time;
  78.           r+w/s, blks/s - number of data transfers from or to device, number
  79.           of bytes transferred in 512-byte (basic block) units;
  80.           avwait, avserv - average time in ms. that transfer requests wait
  81.           idly on queue, and average time to be serviced (which for disks
  82.           includes seek, rotational latency and data transfer times).
  83.  
  84.      ----yyyy   Report TTY device activity:
  85.           rawch/s, canch/s, outch/s - input character rate, input character
  86.           rate processed by canon, output character rate;
  87.           rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt
  88.           rates.
  89.  
  90.      ----cccc   Report system calls:
  91.           scall/s - system calls of all types;
  92.           sread/s, swrit/s, fork/s, exec/s - specific system calls;
  93.           rchar/s, wchar/s - characters transferred by read and write system
  94.           calls.
  95.  
  96.      ----wwww   Report system swapping and switching activity:
  97.           swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and number
  98.           of 512-byte units transferred for swapins and swapouts (including
  99.           initial loading of some programs);
  100.           pswpout/s - process swapouts
  101.           pswch/s - process switches.
  102.  
  103.      ----gggg   Report graphics activity:
  104.           gcxsw/s - graphics context switches per second
  105.           ginpt/s - graphics input driver calls per second
  106.           gintr/s - graphics interrupts other than FIFO interrupts per second
  107.           fintr/s - FIFO too full interrupts per second
  108.           swpbf/s - swap buffers calls per second
  109.  
  110.      ----aaaa   Report use of file access system routines:
  111.           iget/s, namei/s, dirblk/s.
  112.  
  113.      ----qqqq   Report average queue length while occupied, and % of time occupied:
  114.           runq-sz, %runocc - run queue of processes in memory and runnable;
  115.           swpq-sz, %swpocc - swap queue of processes swapped out but ready to
  116.           run.
  117.  
  118.      ----vvvv   Report status of process, i-node, file tables and record lock
  119.           tables:
  120.           proc-sz, inod-sz, file-sz, lock-sz - entries/size for each table,
  121.           evaluated once at sampling point;
  122.           ov - overflows that occur between sampling points for each table.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  136.  
  137.  
  138.  
  139.      ----mmmm   Report message and semaphore activities:
  140.           msg/s, sema/s - primitives per second.
  141.  
  142.      ----pppp   Report paging activities:
  143.           vflt/s - address translation page faults (valid page not in memory);
  144.           dfill/s - address translation fault on demand fill or demand zero
  145.           page;
  146.           cache/s - address translation fault page reclaimed from page cache;
  147.           pgswp/s - address translation fault page reclaimed from swap space;
  148.           pgfil/s - address translation fault page reclaimed from file system;
  149.           pflt/s - (hardware) protection faults -- including illegal access to
  150.           page and writes to (software) writable pages;
  151.           cpyw/s - protection fault on shared copy-on-write page;
  152.           steal/s - protection fault on unshared writable page;
  153.           rclm/s - pages reclaimed by paging daemon.
  154.           Dfill, cache, pgswp, and pgfil are subsets of vflt; cpyw and steal
  155.           are subsets of pflt.
  156.  
  157.      ----tttt   Report translation lookaside buffer (TLB) activities:
  158.           tflt/s - user page table or kernel virtual address translation
  159.           faults:  address translation not resident in TLB;
  160.           rflt/s - page reference faults (valid page in memory, but hardware
  161.           valid bit disabled to emulate hardware reference bit);
  162.           sync/s - TLBs flushes on all processors;
  163.           vmwrp/s - syncs caused by clean (with respect to TLB) kernel virtual
  164.           memory depletion;
  165.           flush/s - single processor TLB flushes;
  166.           idwrp/s - flushes because TLB ids have been depleted;
  167.           idget/s - new TLB ids issued;
  168.           idprg/s - tlb ids purged from process;
  169.           vmprg/s - individual TLB entries purged.
  170.  
  171.      ----rrrr   Report unused memory pages and disk blocks:
  172.           freemem - average pages available to user processes;
  173.           freeswap - disk blocks available for process swapping;
  174.           vswap - virtual pages available to user processes.
  175.  
  176.      ----hhhh   Report system heap statistics:
  177.           heapmem - amount of memory currently allocated to system dynamic
  178.           heap;
  179.           allocd - memory in system heap allocated to callers;
  180.           overhd - system heap block management overhead;
  181.           unused - memory in heap available for allocation;
  182.           req/s - number of allocation requests per second;
  183.           bk/req - number of blocks searched per request;
  184.           breq/s - bytes per second requested of heap;
  185.           brnd/s - bytes per second request round-up by heap;
  186.           bfree/s - bytes per second freed.
  187.  
  188.  
  189.  
  191.  
  192.  
  193.                                                                         PPPPaaaaggggeeee 3333
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  201.  
  202.  
  203.  
  204.      ----IIII   Report interrupt statistics:
  205.           intr/s - non-vme interrupts per second;
  206.           vmeintr/s - vme interrupts per second;
  207.  
  208.      ----UUUU   Report per-CPU utilization statistics:
  209.           Same as -u option except each CPU is shown.
  210.  
  211.      ----RRRR   Report memory statistics
  212.           physmem - physical pages of memory on system;
  213.           kernel - pages in use by the kernel;
  214.           user - pages in use by user programs;
  215.           fsctl - pages in use by file system to control buffers;
  216.           fsdelwr - pages in use by file system for delayed-write buffers;
  217.           fsdata - pages in use by file system for read-only data buffers;
  218.           freedat - pages of free memory that may be reclaimable;
  219.           empty - pages of free memory that are empty.
  220.  
  221.      ----AAAA   Report all data.  Equivalent to ----uuuuddddqqqqbbbbwwwwccccaaaayyyyvvvvmmmmpppprrrrttttgggghhhhIIIIUUUURRRR.
  222.  
  223.      ----TTTT   Report total counts instead of just percentages or per-second
  224.           values.  The counts are calculated by taking the difference between
  225.           the start and end values in the data file.
  226.  
  227. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  228.      To see today's CPU activity so far:
  229.  
  230.           sar
  231.  
  232.      To watch CPU activity evolve for 10 minutes and save data:
  233.  
  234.           sar -o temp 60 10
  235.  
  236.      To later review disk activity from that period:
  237.  
  238.           sar -d -f temp
  239.  
  240.      To show total disk activity from that period:
  241.  
  242.           sar -T -d -f temp
  243.  
  244. FFFFIIIILLLLEEEESSSS
  245.      /var/adm/sa/sa_d_d
  246.                     daily data file, where _d_d are digits representing the day
  247.                     of the month.
  248.  
  249. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  250.      gr_osview(1), osview(1), sar(1M)
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                         PPPPaaaaggggeeee 4444
  260.  
  261.  
  262.  
  263.